What is array-back?
The array-back npm package is designed to ensure that any value provided to it is returned as an array. This can be useful when you are not sure if a function will receive an argument as a single value or an array of values. It helps to normalize the input for further processing.
What are array-back's main functionalities?
Convert a non-array value to an array
This feature takes a single value and wraps it in an array. If the value is already an array, it returns the array unchanged.
[].concat(arrayBack(value))
Flatten nested arrays
This feature can be used to flatten nested arrays into a single-level array.
arrayBack([1, [2, [3]]])
Ignore empty slots in sparse arrays
This feature allows the conversion of sparse arrays into compact arrays without empty slots.
arrayBack(new Array(5))
Other packages similar to array-back
lodash
Lodash is a comprehensive utility library that provides a wide range of functions for working with arrays, objects, strings, etc. It includes methods like _.toArray which can convert values to arrays, similar to array-back, but it also offers a much larger set of utilities for different purposes.
arrify
Arrify is a minimalistic package that converts a non-array value into an array. It is similar to array-back in its basic functionality but does not offer additional features like flattening nested arrays or handling sparse arrays.
array-back
Takes any input and guarantees an array back.
- Converts array-like objects (e.g.
arguments
, Set
) to a real array. - Converts
undefined
to an empty array. - Converts any another other, singular value (including
null
, objects and iterables other than Set
) into an array containing that value. - Ignores input which is already an array.
Example
> const arrayify = require('array-back')
> arrayify(undefined)
[]
> arrayify(null)
[ null ]
> arrayify(0)
[ 0 ]
> arrayify([ 1, 2 ])
[ 1, 2 ]
> arrayify(new Set([ 1, 2 ]))
[ 1, 2 ]
> function f(){ return arrayify(arguments); }
> f(1,2,3)
[ 1, 2, 3 ]
arrayify(input) ⇒ Array
⏏
Kind: Exported function
Param | Type | Description |
---|
input | * | The input value to convert to an array |
Load anywhere
This library is compatible with Node.js, the Web and any style of module loader. It can be loaded anywhere, natively without transpilation.
Node.js:
const arrayify = require('array-back')
Within Node.js with ECMAScript Module support enabled:
import arrayify from 'array-back'
Within an modern browser ECMAScript Module:
import arrayify from './node_modules/array-back/index.mjs'
Old browser (adds window.arrayBack
):
<script nomodule src="./node_modules/array-back/dist/index.js"></script>
© 2015-20 Lloyd Brookes <75pound@gmail.com>. Documented by jsdoc-to-markdown.